Related Items
The Related Items iPart displays a list of images based on the results of an
IQA query. For example, you can write a query to display the profile pictures of
everyone who has registered for an event, or to display products in the same
category.
- Name - Enter a name for the content item. This text only
appears during design mode (configuration).
- Title - Enter the text to display above this iPart on the
rendered page. If blank, no title displays.
- Do not render in design mode - Enable this option to
prevent content record data from being loaded in the content editor. This
improves performance during design time (configuration).
- Display a border around this content - Enable this option
to display a border around this iPart on the rendered page.
- Display content within a collapsible panel - Enable to
allow users to minimize the panel within the page, to work with dense pages
more efficiently.
- Show the content as collapsed - Enable to display the
panel minimized by default.
Tip: Be sure that the
Title makes clear what data is hidden from view.
- Source query - Click select and browse
to the IQA query that you want to see results for in the list.
- Maximum results - Enter the total number of results to be
displayed.
- Description - If you want a description to be displayed
below the title and above the list, enter the text for the description here.
The variable {0} can be used in the description to display the total record
count number. For example, {0} people also bought this product.
- No results found message - Message displayed if no
results are returned. If this field is blank, no message is displayed to the
user when there are no results.
Filter Options
You can dynamically filter the query results based
on the value of a particular property. If a Filter column is selected,
the iPart looks for a URL parameter to set the value for that property. The name
of the URL parameter is defined in the Filter on URL parameter field. For
example, to filter the query to show only the category passed in the URL (for
example Category=GIFTS), choose the ProductCategory column and
specify Category as the URL parameter.
- Filter column - Select a data column to filter the query
results on. Note: Each property you select on the Display tab of
your query in IQA is available as a Filter column option.
- Filter on URL parameter - Enter the URL parameter name by
which you want to filter values. You can use an existing URL parameter, for
example Category, or you can enter a unique value.
Display Options
- Item image file path - Enter the file path where item
images are located, or leave blank to use the default path. If the source
query has a column with an alias of Image, then that value is used for
the image file name, and the default path (if not specified in the query) is
/images/ImageLibrary. If there is no Image column in the source
query, then the default path is /images/Profile. In this case, the
iPart will attempt to locate a profile picture based on the ID for each
result.
- Default item image - Enter the file name for the image to
display when a query result has no image. Include the file path if it is
different than the default path or the path specified in Item image
file path. Example: /images/MySite/default_product.jpg.
- Item image size - Choose a size for the images that are
displayed for the query results.
- List orientation - Choose whether to display the list of
results horizontally or vertically.
- Display item name as - Choose whether to display the name
of each result as a tooltip when the user hovers over the image or as a label
which appears below the image. The source query must include a column with an
alias of Name in order to display an item name.
- Label length - If displaying the item name as a label,
choose the number of characters to display in the label. Names longer than
this will be truncated.
- Items link to (URL or shortcut) - The URL or shortcut
used when the image is clicked. If blank, the image is not clickable. The URL
may be relative to the website root; for example the link to
http://www.yoursite.com/Member/iMIS/ContactManagement/ContactLayouts/Account_Page.aspx
can be entered as
Member/iMIS/ContactManagement/ContactLayouts/Account_Page.aspx. URL
parameters may be added to the URL or shortcut. To dynamically add the value
of an item property, you can include the property or column name as a variable
by enclosing it in {}. For example, to include a product ID in the URL where
the column name for product ID is key_Id, you can append
?iProductID={key_Id} to the URL. For queries that return contacts, the
ID value of the contact is automatically appended to the URL.
Notes
- For sample queries that work with this iPart, see
$/Samples/RelatedItems and $/Samples/QueryProfilePictureList in
IQA.
- For more information, see "Displaying
query results in iParts".